curl --request POST \
--url http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers \
--header 'Content-Type: application/json; charset=utf-8' \
--data '
{
"relabels": {},
"segment_overrides": []
}
'import requests
url = "http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers"
payload = {
"relabels": {},
"segment_overrides": []
}
headers = {"Content-Type": "application/json; charset=utf-8"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json; charset=utf-8'},
body: JSON.stringify({relabels: {}, segment_overrides: []})
};
fetch('http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8000",
CURLOPT_URL => "http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'relabels' => [
],
'segment_overrides' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json; charset=utf-8"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers"
payload := strings.NewReader("{\n \"relabels\": {},\n \"segment_overrides\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json; charset=utf-8")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers")
.header("Content-Type", "application/json; charset=utf-8")
.body("{\n \"relabels\": {},\n \"segment_overrides\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json; charset=utf-8'
request.body = "{\n \"relabels\": {},\n \"segment_overrides\": []\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"workspace_id": "<string>",
"status": "<string>",
"progress": 123,
"error": "<string>",
"segment_count": 123,
"segments": [
{
"id": "<string>",
"start_ms": 123,
"end_ms": 123,
"text": "<string>",
"speaker_label": "<string>",
"confidence": 123
}
],
"created_at": "<string>",
"content_visible": true,
"elevation_required": true,
"session_was_deleted": true,
"transcription_id": "<string>",
"session_id": "<string>",
"detected_language": "<string>",
"forced_language": "<string>",
"diarisation_model_version": "<string>",
"transcription_text": "<string>",
"speaker_count": 123,
"duration_ms": 123,
"avg_confidence": 123,
"completed_at": "<string>",
"deletion_event_kind": "<string>"
}{
"success": true,
"message": "<string>"
}{
"success": true,
"message": "<string>"
}{
"success": true,
"message": "<string>"
}Apply a flat rewrite map to the segments' `speaker_label`...
curl --request POST \
--url http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers \
--header 'Content-Type: application/json; charset=utf-8' \
--data '
{
"relabels": {},
"segment_overrides": []
}
'import requests
url = "http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers"
payload = {
"relabels": {},
"segment_overrides": []
}
headers = {"Content-Type": "application/json; charset=utf-8"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json; charset=utf-8'},
body: JSON.stringify({relabels: {}, segment_overrides: []})
};
fetch('http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8000",
CURLOPT_URL => "http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'relabels' => [
],
'segment_overrides' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json; charset=utf-8"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers"
payload := strings.NewReader("{\n \"relabels\": {},\n \"segment_overrides\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json; charset=utf-8")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers")
.header("Content-Type", "application/json; charset=utf-8")
.body("{\n \"relabels\": {},\n \"segment_overrides\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://0.0.0.0:8000/api/admin/jobs/transcriptions/{job_id}/relabel-speakers")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json; charset=utf-8'
request.body = "{\n \"relabels\": {},\n \"segment_overrides\": []\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"workspace_id": "<string>",
"status": "<string>",
"progress": 123,
"error": "<string>",
"segment_count": 123,
"segments": [
{
"id": "<string>",
"start_ms": 123,
"end_ms": 123,
"text": "<string>",
"speaker_label": "<string>",
"confidence": 123
}
],
"created_at": "<string>",
"content_visible": true,
"elevation_required": true,
"session_was_deleted": true,
"transcription_id": "<string>",
"session_id": "<string>",
"detected_language": "<string>",
"forced_language": "<string>",
"diarisation_model_version": "<string>",
"transcription_text": "<string>",
"speaker_count": 123,
"duration_ms": 123,
"avg_confidence": 123,
"completed_at": "<string>",
"deletion_event_kind": "<string>"
}{
"success": true,
"message": "<string>"
}{
"success": true,
"message": "<string>"
}{
"success": true,
"message": "<string>"
}Path Parameters
Body
Body for POST /admin/jobs/transcriptions/:job_id/relabel-speakers.
Two complementary rewrite mechanisms, applied in order:
-
relabels— flat rewrite map applied to every segment whosespeaker_labelmatches a key. To merge S4 into S1 AND rename S1 to "Moderator", the client should send both rules already resolved:{"S4": "Participant", "S1": "Moderator"}. This is the bulk path and is the only one that propagates to Neo4j:SpeakerIdentity. -
segment_overrides— per-segment fixes for cases where one misclustered segment shouldn't drag its whole speaker group with it. Applied AFTERrelabels, so the operator can do "merge S1+S2 into Moderator AND override segment X to be Participant" in one save. Single-segment moves are intentionally Postgres-only — too small a sample to meaningfully shift centroid clusters in Neo4j.
Response
jobs.id (same id the admin list returns).
Show child attributes
Show child attributes
True iff transcription_text and segment text are populated normally.
False means the admin is not a native member of this session AND has
not elevated; content fields contain a placeholder & the UI should
show the "View content (audited)" banner.
True iff the admin needs to POST /admin/content-elevate w/ a
reason to see content. False either when the admin has access
natively (member/owner/share) or has already elevated.
Set when this transcription's content was redacted via session
deletion (i.e. transcription_text contains a [redacted-…]
placeholder). Lets the UI show a "Deleted session" badge instead
of a confused "Workspace-level" one.
transcriptions.id — the row that backs this job's output.
When session_was_deleted is true, this is the matching
gdpr_log.event_kind — e.g. session_deleted_by_owner or
account_erasure_session_redacted. Lets the UI render an honest
"why" without exposing actual user identifiers. None when no
matching gdpr_log row was found (older deletions before the audit
pipeline existed; or non-redacted transcriptions).